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WARNING ! 



HYPERZAP is a disk zap program and as such is capable of modifying your 
disks. It is your responsibility to read the manual and take any precautions 
neccessary to protect any data you value. At the least, any master disks 
should always be write protected. You may also modify any part of memory 
including HYPERZAP itself. You do this at your own risk. Hypersoft and the 
Author offer this program on an as-is basis only and assume no responsi bi 1 ty 
for any loss or consequential damage resulting from its use or misuse. 
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HYPERZAP is designed with many -features to make it easy to analyze or 
backup an unknown disk. Because of the many ways that information can be 
laid down on a disk the user must be prepared to learn something about the 
way tracks are formatted. Only with this knowledge can the full features of 
HYPERZAP be taken advantage of. Among the many features of HYPERZAP are: 

- Works in SINGLE, DOUBLE and MIXED sector densities so you can work 

with disks designed to boot on Models I, III and IV. These disks 
often have both single and double density sectors on one track. 

- DOUBLE SIDED disk drives supported as two single sided drives. 

- 80 track drives supported. 

- B inch drives supported (Model III and IV). A suitably designed disk 

controller is needed for this. The standard Radio Shack board will 
not work. Holmes and Micro-Mainframe are among the suppliers of 
suitable controllers. 

- Analyze a track to determine the format. 

- Read/Write tracks sectors. 

- Read/Format a whole track. 

- Build a directory table describing each tracks statistics. 

- Edit memory, sector and track data. 

- Move, find and fill memory, calculate CRCs. 

- Backup a disk. 

- Autopilot. This exciting new feature allows Hyperzap to record any 

sequence of actions for future re-use. Your Hyperzap disk comes 
with several examples enabling you to back up some of the most 
well known hard-to-copy programs. 

- Make your own dual Model I/III,IV self-booting disks. If you have 

developed your own machine language program and you want to put it 
on a disk to run without a DOS then this feature is for you. 

- Screen print for permanent record use. 



Backup has many features not the least of which is that special 
consideration has been given to single drive user. The general backup 
analyzes the source disk track by track, determining the number of sectors, 
their kind and their angular position on the disk. This information is put 
in the directory and after reading the sector data the destination disk is 
formatted in the same way and the sector data written. Single drive users 
should note that there is enough free memory to transfer about 8 single or 
5 double density tracks per disk swap. 
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2,Q GETTING STARTED 

There are two versions of HYPERZAP, one for the Model I and one for the 
Model III. Both are on your disk and may be removed and made into command 
files if you wish. The program is supplied as a self booting disk which will 
auto run when you hit reset. When you run the program it will load and then 
relocate part of itself down over the top of DOS which is no longer needed. 
This way the maximum space is available for track and sector data storage. 
Do not use any part of memory between 4000H and the top of the program for 
your own purposes (see H command) or strange and unpredictable things will 
happen I . 

Although the program has been provided on a self booting disk you may 
prefer the flexibility of using it as a command file instead. This has the 
advantage of being on your DOS and easily transferred from disk to disk. 
However there are three disadvantages: 1) You cannot use the self booting 
disk maker feature from a /CMD file version; 2) you will have no access to 
the supplied autopilot programs unless you insert your Hyperzap master and 
3) Hyperzap loads faster from the master disk than from a DOS. A special 
feature has been built in to make it easy for you to transfer Hyperzap to 
the DOS of your choice. 

To make yourself a command file, insert your Hyperzap master in Drive 
and press reset to load. At the same time, hold down the three keys MJG 
simultaneously while the program is loading. Instead of the normal greeting 
coming up you will see a command such as: 

DUMP filespec (START=X ' BFFS ' , END=X ' C33B ' , TRA = X ' C302 ' ) 

which is the form of the Dump memory to disk command in TRSDOS. What has 
happened is that after loading the program a copy was also transferred into 
high memory together with an appendage. If you were to start running at the 
address TRA the appendage would copy the entire program back and start 
running it. At this point you must take your Hyperzap disk out and replace 
it with a disk containing the DOS of your choice. Press the reset button on 
your computer to reboot and then type in the command as above substituting a 
suitable file name and the exact numbers as they appeared on the screen. The 
DUMP command is different in some DOSs so adapt as neccessary. Note that 
START is the beginning, END is the end and TRA is the transfer address of 
your copy of Hyperzap that you must save to DOS. 

HYPERZAP has three major screen modes. The main mode which comes up at 
the program start has a menu of major options most of which are selected by 
keying a single letter. Also included on this screen are the specifications 
for the source and destination drives which can be configured for your 
machine through the parameter change option. The two other main screens can 
be reached by typing D or I as below. 

D nn - Display Track Sector Table. 

Pressing "D" followed by a 2 digit number will take you to the 
Directory screen that displays the sector configuration of a particular 
track. This is a very important feature which allows you to analyze and 
understand the makeup of an existing disk or to create a new one. Initially 
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this intonation screen will contain no data until either you read an 
existing disk or you enter some sector descriptions yourself using the 
Append, Insert or Edit options. Siven valid data -from a real disk you can 
point to a particular sector in the directory with the cursor arrow, read 
the sector data into memory, edit it, and rewrite it. Unlike many DOS 
supplied Zap programs HYPERZAP does not care whether the disk is in a 
standard format . You can, -for example, edit a double density sector 
residing on an otherwise single density track. 

The number you type for the track may be in decimal or hexadecimal 
(signified by I sign) thus D 10 and D *0A will both take you to the entry 
for track decimal 10. Note that 2 digits must always be typed. 

I hhhh - Memory Inspect/Edit 

Back in the main menu again, pressing "I" followed by a 4 digit 
hexadecimal memory address, will take you to the third screen which is a 
screen oriented memory inspect and change subprogram with many useful 
features for creating, copying and editing disk data. This is also called 
when you do a whole track read from the Main Menu or a sector data edit from 
the Directory Screen. 

H - Help 

Every screen has been provided with a (hopefully) descriptive menu of 
options and, when that option is selected, additional sub-prompts are 
provided. A helpful feature is provided in all 3 screens where, by pressing 
the H key, data will be displayed showing the memory occupied by the program 
and the various data stores such as the Directory, Sector Data and Track 
Buffer. This tells the user immediately where everything important is and 
therefore what free space is available. While in the help mode you can send 
the contents of the current screen to your printer by pressing the P key. 
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3.Q Main Menu Options 



This chapter describes in detail all the options obtainable from the main 
menu. Each command line can be edited using the backspace (left arrow) key. 
No action takes place until the enter key is pressed. Note that the symbols 
d and h are used below to denote a single decimal or hexadecimal character 
respectively. Note also in the examples your input is shown underlin ed. 

A dd or A $hh Read Address Marks 



Typing "A" followed by a track number causes the selected drive to seek 
that track and then make 8 passes, 3 in single and 5 in double density, each 
time reading and recording any sector ID address marks and the angular 
position round the disk is measured from the index hole. The resultant 
information is then checked and averaged and entered in the directory. To 
see the result you will have to type D dd to display the directory entry for 
that track. 

Example of use: A 03 

Explanation: read track 3 to find any sectors that exist 

and enter them in the track table in proper 

order as measured from the index hole. 

B Generate an sel f -Booti ng disk. 

This option gives you the ability to take a machine language program 
and put it on a disk that will boot automatically and run the program on a 
Model I, III or IV. To use this you will have to prepare your program so that 
it loads and runs at 5400 Hex. You must the move it up into high memory so 
that it will not be destroyed when you load Hyperzap. The present version of 
Hyperzap requires you to place your program at 9800 Hex. 

To produce a self booting disk do the following: prepare your program 
as a command file and load it into memory at 9800 Hex. If your file needs to 
run at some other location use a block move to prepare an exact copy 
starting at 9800. Run Hyperzap which loads into low memory and call the B 
function from the main menu. Hyperzap will first ask you for the upper limit 
of your file. From this it can compute how many formatted tracks you will 
need. Hyperzap then builds a disk from track 1 to track N with b sectors of 
double density and 6 of single density on each track. Then it formats and 
writes the sector data to disk. You can make your disk model I or III/IV 
only by laying down data only in the single or double density sectors 
respectively. If you want both you will have to make a second pass without 
formatting. Reply S or D to lay down the sectors in single density for Model 
I or double for model III/IV. Insert your destination disk and answer Y to 
the format question if this is the first pass. Hyperzap will then take your 
data, format the disk and write the sector data. The program then adds the 
boot sectors on track by copying them form your master disk. The load and 
run addresses are modified to suit your own requirements. 

Example of use: 

Suppose you have a file that loads at 6000H to 6100H and starts at 6030H 
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and you want to put it on a disk so that it will boot and run on a model I. 
First you must load it into memory from your DOS and move it up to 9B00H 
using a block move utility. Then boot Hyperzap from a self booting disk. 
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prompt, enter the upper limit of your file. 
S for Model I, single density. 
Y as we are starting with a blank disk, 
yperzap copies the boot sectors from your master. 

doing so the program load and run addresses are modified 

your needs. 



C Clear Directory 

C clears the track sector table of all previously read or created 
entri es. 

Example of use: C_ 

Explanation: clear track sector table. 

D dd or D fhh Display Directory 

D switches the display mode to screen 2, Directory display. The 
directory display will be entered pointing at the track number specified. 
From there you can page forwards and backwards through the tracks using the 
Shift-Up-Arrow and Shi f t-Down-arrow-Z control keys. See section 4.0 for a 
detailed description of the functions available. 

Example of use: D 03 

Explanation: Display the track sector table for track 3. 

E dd or E fhh Combined A, S, D command 

E gives you the ability in one go to read the address marks of a track, 
read the sectors and then go and display the result. See the descriptions of 
the individual commands. 

Example of use: E 03 

Explanation: Equivalent of A 03 S03 D 03 
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This shows the memory space currently occupied by the program and all 
the main data storage areas. You need this if you are going to make use of 
some spare space to build a sector of data. As a general rule all memory 
between 4000 hex and the top of the track sector directory should not be 
overwritten. Space above the start of Sector Data is fair game and above 
E700 also if you do not intend to do a track format. 

screen by pressing the P key. The H command can be called from all 
screens. 

Example of use: H_ 

Explanation: calls help information at bottom of screen. 

I hhhh Inspect/Modify Memory 

I followed by a 4 digit hexadecimal address switches display to screen 
3, Memory Inspect/Edit mode. You must use 4 digits and no preceding f to 
specify the address. The screen will show the contents of memory in 11 lines 
of 16 bytes each starting at the address specified. In this mode you can 
scroll through memory inspecting and modifying it as desired. See section 
5.0 for more details of the features available. 

Example of use: I BS00 

Explanation: Display memory starting at B800 hex. 

J hhhh Jump to Memory 

J followed by a 4 digit hexadecimal address and <enter> causes the 
program to jump (tranfer control) to start executing a program at the 
address specified. 

Example of use: J C000 
Expl anati on: 



start executing program at C000 hex. 



Port I/O 



will prompt you for a hexadecimal 2-digit port number, it will then 
print the value obtained by reading that port address and wait for you to 
enter a 2 digit hex value to be sent to the same address. Any non valid 
entry will abort without sending anything so you can type <enter> if you 
just wanted to read the port. 

Example of use: 

0_ 

Port I/O - enter Port # (Hex) : F0 80 Bl_ 

Expl anati on: 

Inspect contents of port address F0 hex and change 
from 80 to 81 hex. 

P Change Drive Parameters. 
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The two columns at the right hand side of the screen indicate the 
pareffleters of the two drives that will be used as the source and destination 
drives in any operations selected from the menu. A cursor immediately below 
one of the columns points to the one that is currently selected for any 
manual operations. For example if the cursor points to the left hand column 
then that is the drive that will be used in any disk read write commands 
called using the A,S,Q,R and W options. Typing P allows you to go to the 
parameter set up mode where you can change the drive selection and any of 
the individual drive parameters. 

To select a drive, use the left or right arrow to move the cursor to 
point at the appropriate one. To select a parameter use the up and down 
arrows to move the parameter select cursor. The two cursors jointly point to 
the parameter of one drive that can be changed. To change the parameter type 
space followed by the new value Most values can be entered as a 1 or 2 
digit decimal number but the drive number should be given as a single digit 
(0-3). The Clear key returns control to the main menu. Note that the 5/8 
inch mode is not implemented on the Model I. 

Several of the parameters need some explanation. The stepping rate 
number should be 00,01,02 or 03 for actual disk stepping rates of 3,6,12 and 
30 milliseconds respectively. Most older drives were slow and take 30 mS. 
New drives can be as fast as 6 mS. The track offset number is added to the 
specified track in any operation. The sector skew number is used only where 
a group of sectors are read or written. It has 2 main uses: it speeds up 
reading and writing groups of sectors, it allows you to read sectors into 
memory in a sequence detemined by the skew. For instance with 10 sectors 
nuiTibered 1 , 2 , 3 , 4. . . . 8 , 9 , 10 a skew of 2 would read them 1,3,5,7,9,2,4,6,8,10. 



Example of use: 



use arrow keys 
space key 



Note 

1 
2 



Expl anati on : 



calls parameter change mode. 

select drive and parmeter to change. 

space key says we want to change selected parameter 

value for changed parameter. 



Q dd or Q $hh Write Tracks Sectors 

Q followed by a track number causes all that tracks sectors to be 
written to the disk. To do this the track must be already formatted and you 
must have some valid sectors listed in the track table for that track. Only 
sectors identified in the track table will be written and even then only 
those with good data (valid CRC). Also, a sector will not be written to disk 
if the Data Location pointer in the directory is set to less than 0100. 
(Normally when you read the address marks of a track, an initial entry is 
created for each sector but, as the data for that sector has not been read 
in yet, the Data Pointer is initialized to zero which acts as an indicator 
that no valid data exists.) 



Example of use: Q_03 
Hyperzap Version 3.0 



-=<*>=- 



Copyright 1983, Hypersoft 



Chapter 3 Main Menu Options Page 9 

Explanation: write the sectors o-f track 3 to disk. 

R S dd or R S *hh (or R D »#) Read Track 

R S Track number or R D Track number will do a whole track read and 
load the resulting data into the track buffer starting at address E700 hex. 
After that HYPERZAP will automatically switch to the memory inspect/edit 
screen showing the start of the track's data. S selects single density and D 
selects double density read. Track read gets all data including the 
intervening gaps between sectors and the sector address marks. On double 
density it is usually the case that sector data is not all valid because of 
the way the floppy disk controller works. 

Example of use: R D 3 

Explanation: Do a double density track read on track 3, 
reading the contents into memory at E700H 

S dd or S $hh Read Tracks Sectors 



S followed by a track number causes the selected drive to seek that 
track and read data of all that track's sectors into memory. You must have 
preceded this command by an operation which put some entries in the Track 
sector table because only the sectors identified as being present will be 
read. Typically you might have done an A dd in the main menu which would 
have read all the sector address marks on track dd and then you could do an 
S dd to read the data in the sectors listed. Data will be stored in the 
sector data storage area and the start of each sector's data will be 
identified in the directory. Also the address mark will be decoded and 
entered in the directory. In fact only when the sector data is read can all 
the missing bits of information be filled in. Now we can determine the 
length of the sector, whether it is in IBM or non-IBM format and whether the 
Cyclic Redundancy Check (CRC) is good. 

Example of use: S 03 

Explanation: read the sectors of track 3 into memory. 

Note that sectors are read into memory in the order they occur in the 
Track Sector Table which is not neccessar i 1 y in sector ID numerical 
sequence. This is only true however if the sector skew is set to i. If you 
look at the parameter options on the main memu you will see that this is a 
user changable function. If, for example you change the skew to 3 then every 
3rd entry will be read in. Suppose that the track table has sectors listed 
as 1,2,3,4,5,6,7,8,9,10 then they will be read in in the order 
1,4,7,10,2,5,8,3,6,9. 

T dd or T *hh Seek Track. 



T gives you manual control over the position of the heads in your 
drives. Typing T 00 forces a restore to track which is useful if you 
change the drive selection using the parameter change feature and don't know 
where the head of the new drive is. The drive selected is the one in the 
main menu screen pointed to by the cursor below. 

Example of use: T 13 
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Explanation: »ove the head of the current drive to track 13. 

W dd or W $hh Write (Format) a track 

W ## will take the sector descriptions for that track from the 

directory and -format the track with all sector data set to E5 hex. Any 

mixture and sequence of sector lengths and densities can be used provided 
sufficient clearance is allowed between them. 

Example of use: W 03 

Explanation: Format track 3 using information from the 
track table for track 3. 

X C Whole Disk Copy 

XC is the automatic copy routine which copies a whole disk or group of 
tracks. Follow the prompts and, for many disks that is all that is needed. 
Model III users may not be able tD copy all Model I disks because the Floppy 
Disk Controller can only read and write data marks F8 and FB whereas the 
Model I can read and write data marks FB,F9,FA and FB. Models III/IV will 
convert F9 to F8 and FA to FB. Also, Model Is can read and write single 
density sectors in what is called 'Non IBM format'. This allows a sector to 
be any length from 16 to 4096 bytes in multiples of 16 bytes. Use of this is 
very rare except on some early protected Model I disks. Certain disks will 
have to have some tracks copied manually. To do this you will have to read 
the address marks (A), read the sectors (S) , format the track (W) and write 
the sectors (Q). You can also do a track read (R) to examine the makeup of 
the track, possibly edit the directory (D) and construct special sectors 
from the information gleaned from the track read. With these tools you can 
backup or create most disk formats that have been produced to date - plus 
many that haven't. Known formats that can be copied include TRS80, IBM PC, 
CP/M and TI 99/4 disks. 

Example of use: 

Note: your input is underlined. 

i xc' 

2 Press Enter when source disk in drive enter 
Press Enter when destination disk in drive enter 

3 Pause on non standard tracks ? (Y/N): Y 

4 R Regular 10 sectors single /18 double or S special ? S 

5 Special; Enter # of sectors expected: 12 

6 Any options Y or N ? Y 

7 Force track i/d to match physical track # Y/N; Y 

8 Enter starting Track No. (Decimal): 1 
Enter No. of tracks (Decimal): 3 

9 Analyzing Address Marks and Reading Sector Data: 
SSSDDDSSSDDDSSS OCH sectors, 0C00H bytes found. 
.... copying procedes. 

Expl anat i on: 

1: Copy all or part of one disk to another. 

2: Insert source and destination disks 

3: Program will pause if bad track found. 

4: R for standard TRSBO disks, S for others. 

5: In our example we expect to find 12 sectors per track. 
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6: Only one option available in present release 3.0 

7: If Y then destination sector i/d's are adjusted so track 

byte matches actual physical track no. 
8: De-fine range of tracks to be copied. 
9: Copying now starts. 

Z Autopilot Commands 

Z -followed by a second letter sets up execution o-f one o-f the Autopilot 
commands. The Autopilot allows Hyperzap to learn a sequence of keystrokes. 
Once learnt, the sequence is like a program that can be rerun at any time to 
duplicate the original operation no matter how complicated. All the 
autopilot commands begin with the letter Z and are called from the main menu 
screen. The commands are as follows: 



ZL turn Autopilot mode on. 

Once on the program records every keystroke from the keyboard no matter 
what screen you are in. A maximum of 1024 bytes is assigned for storage 
and when that is exceeded the program will automatically drop out of 
learn mode. 



X exit (terminate) learn mode. 

Once you exit the learn mode, no more keystrokes ar 
want to see the extent of the auto program you have 
H (help) key to display the storage address limits. I 
it to disk you must do the following: use a copy 
master disk and write the contents of the autopilot 
free program sector on that disk. You must know what 
Suppose you want to save the autopilot program to 
from the main menu type C to clear and then type A 16 
for track 16 in the track table and D 16 to show t 
There are 2; move the cursor to the one you want to u 
so that the data start is indicated as 8800 (the star 
memory region) and type Z to write the sector. 
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ZP run Autopilot program. 

When you enter the autopilot run mode, whatever is stored in the 
autopilot program area will be executed, substituting stored characters 
for commands that would normally have come from the keyboard. The 
program will abort if an error is encountered. If the source and 
destination are specified as being the same the the program will stop 
any time a change between source and destination is needed. This will 
allow you to change disks and press the enter key to resume. 



ZG dd Get a program from disk 

Each program occupies one 1024 byte sector. These sectors are provided 
on your master Hyperzap disk starting at track 13 decimal. There are 2 
sectors per track and thus 2 programs. Programs are numbered 
sequentially starting with and 1 on track 13. Thus ZG 04 will load 
the first sector from track 15. At present your disk comes with 5 pre- 
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recorded sectors which contain: 

00 Text -file giving directory of programs. 

01 Hyperzap self copy routine. 

02 Super Utility 2.2 Backup. 

03 Super Utility 3.1 Backup. 

04 Brandon Loader Backup. 

Program 04 works on most Med Systems disks plus some -from 
Melbourne House and Displayed Video. These disks can be identified by 
the fact that there are only 3 sectors on track and on track 3 there 
are 5 good sectors with a 6th sector which has a CRC error. All other 
tracks have 10 sectors of single density. 

Example of use: First, insert Hyperzap disk in drive 
and blank disk in drive 1. Then type: 
ZG_01 to load Hyperzap self copy 
ZP to start program. 

If you have only 1 drive first set the Destination drive to 0. Then 

procede as before, wait for prompts to change disks. 
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When HYPERZAP reads a disk it builds entries in a "Track Directory" 
which describes exactly how each track is -formatted, how many sectors of 
what density and type and where they are positioned on the track. In the 
disk copy mode this directory information is used to rebuild an image of the 
track in the track buffer and subsequent formatting of the destination disk. 
Note that this directory is NOT the same as the kind of directory you have 
on your regular DOS disks. Once the destination disk is formatted the sector 
information can be written. 

In the manual mode the directory can be generated by reading address 
marks from an existing disk or by building entries using the directory edit 
features. In addition, a sector shown in the directory can be read into 
memory, editted and re-written to disk either in the same or an alternate 
position. 

4 .J The Directory Display. 

The display consists of three parts, the main part being the directory 
itself. To the left of this is some general information and an indicator 
oivinq the current track you are looking at. You can page forward or back to 
look at other tracks using Shi f t/down-arrow/Z and Shift /up-arrow 
respectively. 

The directory display consists of a number of columns as follows: 

#.... Sequent i ai sector number (in decimal) for information only, no 
relation to the actual sector numbering. 

Tk...The logical track number as given in the address mark. 

Sp...The spare byte given in the address mark. Sometimes used to 
indicate the side on two sided disks. 

5c... The logical sector number given in the address mark 

Ln...The length code. In IBM 00,01,02 or 03 standing for 128,256,512 
and 1024 bytes respectively. In N(on) IBM 01 , 02 , 03, . . . FF , 00 for 
16,32,48, .. .4080,4096 respectively 

CRC..Y for yes if the address mark is good as it will be if address 

mark is good as it will be if the directory was read from a disk. 

May be N if we want to create a special address mark without a 
valid CRC. 

DAM. .No swearing now!. Sometimes you might, want to with disk in the 
middle of the night. DAM stands for Data Address Mark and is a 
byte recorded immediately before the sector data on the disk. Can 
be F8,F9,FA or FB in single density Model I and F8 or FB in double 
density Model I/III/IV. 

Data.This is a 4 digit hexadecimal number specifying where in memory 
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Angle. ..This is a decimal number -from to 6250 telling angular 
position round the disk of the start of the sectors address mark. 
Each unit represents one byte round the disk in double density. 
(Half a byte in single.) Displacement is measured from the index 
hole, being the start and 6250 one full revolution. 

Type. This is a code specifying the type of sector. The following codes 
are allowed: 

IBM a standard type sector. 

NIBM a standard non IBM sector. The length is 16 times the sector 

length code. Available on Model I single density only. 
W special block of data to be included on formatting. 
X the sector data does not have a valid CRC. 
X the sector address mark does not have a valid CRC. 
Z neither data nor address mark has a valid CRC. 

CRC. .If Y for yes then data read from an existing disk had a valid 
cyclic redundancy check. If N for no then when a destination disk 
is next formatted no CRC will be put there. 

Dens. Density of sector - S Single, D Double density. 

4.2 The Directory Menu 

A cursor points to one of the sectors and this is the sector that will 
be operated on by one of the commands in the menu below the main screen. You 
can move this cursor by means of the up and down arrows. The options in the 
menu are as follows: 



A - Append a new sector entry after the cursor. The sector parameters 
must be entered as in the example below. 



C - 



D - 
E - 

R - 



Copy the current track entries up to the next track. The track 
number will be updated to match the actual track number. This is 
useful for rapid generation of your own formats. No duplication 
will take place if entries already exist in the track above. 

Delete the sector entry pointed to by the cursor. 



Edit the current sector entry. Follow the 
skip a reply if you don't want to change 
using the enter key. See example below. 



prompts given. You can 
the current value, by 



Generate a standard track. This allows you to build an entry of an 
arbitary number of equally spaced sectors. The new sectors will 
be appended to any already existing in the table for that track so 
you can build a entry of say 5 sectors of one density followed by 
5 of another. Sector spacing is calculated from requirements of 
sector size and density. The sectors will be numbered according to 
one of 3 options: 1 count down, 2 count up, 3 skewed (interleaved) 
count. See example below. 
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I - Insert a new sector entry before one currently pointed to by the 
cursor. See example below. 

M - Bo to edit memory (Hain menu 'I') mode to edit sector data. When 

you do this the Hi and Lo Limit Indicators show the bounds of the 

data. The R command will return you to the same place in the 
directory. 

R - Read the current sector to memory. You will be asked for a 
destination memory address. Use H before you do this if you want 
to see what space is free. This is a useful command if you want to 
extract the boot sector from a disk. When you have loaded it you 
can reboot your DOS, dump it to disk 
disassembler. You can also disassemble it 
Generally, anything in high memory will 
your DOS or Hyperzap. 



and run it through a 
in memory where it is. 
be untouched by booting 



force the track byte to the same value. Example: T 09 makes all the 
sectors have 09 as their tk byte. 

Zap the sector - i.e. write it back to disk at your own risk!. The 

sector pointed to by the cursor will only be written to if the 

data location is non zero and the sector is an IBM or NIBM type. 

Other types are only used in formatting. 



The W sector definition is not really a sector at all. It gives you a 
way of defining all or part of a track in any arbitrary way you like. You 
can build a block of memory using the memory inspect/modify mode and then 
define it to be a W sector. This will be copied exactly to the track when 
you do a track format. (W, main menu). Remember though, that the floppy disk 
controller will replace some bytes. F7 for instance gets replaced by the 2 
byte contents of the CRC register. 

While in the Directory mode you can page forward and backward through 
the track entries by using Shift-Up-Arrow and Shi f t-DownArrow-Z . 

Here we are going to create a double density regular sector. 

Note your replies are underlined. 

E 

Density - (S)ingle or (D)ouble D 

Enter code for sector type: Space = standard IBM, N=Non IBM 

W = Special format block, X = No data CRC, Y = No ID CRC, 

Z = No data or ID CRC : _ (space entered) 

Spare byte: 00 

Logical Sector #: 06 

Length Code : 01 

Start of Sector Data (4 digits Hex): 9000 

Sector Angular Position 0-6250 Decimal: 0196 



Hyperzap Version 3.0 



-=<♦>=- 



Copyright 1983, Hypersoft 



Page 16 



Using the Directory 



Chapter 4 



Generate Example 

Here we are going to generate a track with 10 sectors using an interleave 

skew factor of 3. 



No of sectors 10 

Sector count 1 down, 2 up, 3 skewed: 3 

Initial sector # Hex: 01 

Highest sector # Hex: 0A 

Sector skew Hex: 03 

Density - (S)ingle or (D)ouble D 

Enter code for sector type: Space = standard IBM, 

W = Special format block, X = No data CRC, Y = No 

Z = No data or ID CRC : _ (space entered) 

Bytes / Sector: 256 (note decimal) 



N=Non IBM 
ID CRC, 



Result: sector sequence 01 , 04 ,07 , 0A, 02, 05, 08,03 , 06, 09, 
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5 - Q Memory Inspecti/Modi-fy Mode 



This is the third screen. It gives you a scrolling window on memory, 
all the arrows and shift-arrows do something - try them. You must press the 
Z key as well when you want shift down arrow. The flashing cursor points to 
a memory location which will be operated on if you try any option key. An 
indicator top left gives the actual memory address. Other indicators are 
Marker 1 and Marker 2, L low limit, U upper limit and a continuous 
length/CRC indicator. This screen allows you to alter any part of memory and 
to examine previously read track and sector data. Use the H key to see where 
HYPERZAP is and keep away from this region as modifying it may be hazardous 
to the health of your disks!. Options available in the present version are 
as toll ows: 



S Search 



Search for a hexadecimal string. Enter the string in hexadecimal 
character pairs for each byte. Search will be from the current cursor 
position plus one to Upper Limit. The Upper limit is automatically set by 
sector and track read commands but you can change it manually (U command). 
The search string can be defined in ASCII or hex by preceding it with either 
an or a I sign. 



Example: 



5 

'text 

$0102 



( search ) 

(find the string: text) 

(find the 2 bytes 0102) 



C Calculate CRC; 
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M Modify Memory. 

Once in this mode any hex key 0-9, A-F will overwrite the current cursor 
position. Two cursors show your current position, one in hex and one in the 
ASCII sections of the display. You can switch between editing in hex and 
editing in ASCII by typing the ' symbol or back to hex by typing the I 
symbol. In either mode there is an additional memory i nsert /del ete feature. 
This operates on current memory up to the upper limit set by the U marker. 
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Insert generates an 00 byte at the current cursor location and moves all 
memory above up to the Hi limit up by one byte. Delete removes one byte at 
the current cursor location and moves memory above down by one byte, -filling 
in at the top with 00 bytes. In the hex mode use X to delete and I to 
insert. In the ASCII mode use Control-D and Control-F. (You get this by 
holding the shift and down arrow keys together with D or F). Clear exits the 
modify mode. 



B Block Move. 



Using this a block move 
modes, one for a straight mo 
process. As the move proceeds 
would cause a floppy disk c 
corresponding program CRC is r 
byte updates the CRC count. I 
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1 , 2 Set Markers. 

Keying the digits "1" or "2" will set Marker 1 or Marker 2 to the 
current cursor address. Useful in CRC, Search, Fill and Block Move 
operations. 



L,U Set Limits. 

Keying "L" or "IP will allow you to enter a 4 digit hex number for the 

lower and upper limit markers. These markers do not stop you scrolling or 

modifying memory. They are simply reminders. The upper limit also acts as a 
stop when searching memory (S). These two markers are set automatically when 

you do a track read or a sector data edit (see R below and the M command in 
secti on 4. ) 



R Return to Directory . 

Use this if you have previously read a sector in Directory (screen 2) 
mode and have come to this screen to view or edit the data. R will return 
you to the same point you left with the cursor still pointing to the sector 
in question so that you can simply rewrite it to disk by hitting Z. See the 
M command in section 4. 



A New Address 
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"A" will allow you to specify an address of a new part of memory that 
you want to inspect and modify. Enter the address as a 4 digit Hex number 
when you see the > prompt. The screen will be repainted with data starting 
in the top left hand corner of the screen at the address you just entered. 

F Fil l Memory. 

"F" allows you to fill memory from Marker 1 to Marker 2 with a 
specified string of data bytes. Memory is filled from the Marker 1 to Marker 
2 with the string from Marker 1 to the current cursor position. The best way 
to use this is to move the cursor to the end of the space you require 
filling, press 2 to set Marker 2 and then go to the start of the space to be 
filled. Press 1 and then M to go into edit mode. Enter the bytes, editing as 
neccessary and then get out of edit with the Clear key. The cursor should 
point at the last character of the string you have just entered. Press F and 
the job is done. Be careful the markers are set correctly. M2 should be 
higher than Ml or all of memory will be wiped out including Hyperzapi. 

Example: suppose you want to fill a region of memory with many copies of the 
word Hyperzap. Go to the end of the region and press 2 to mark the end. Go 
to the beginning and press 1 then M to edit: Type 'Hyperzap to insert the 
word in ASCII mode at the beginning, use Clear to get out of Modify and type 
F to fill. 
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6> , O A Guided Torn- o-f Hypei^Zap, 



One o-f the best ways o-f learning to use the program is by example. The 
instructions that follow are intended to take you, step by step, through the 
most important features o-f Hyperzap. Please refer to the figures at the end 
of this appendix where neccessary. In general you should see the same on 
your screen except in the bottom 3 lines which will show the command 
options on screens 2 and 3 and will be blank on the main menu. For the 
figures here we had to go to the Help mode (by typing H) to get a screen 
print. 
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excercise some of the main menu functions. Figure 1 shows 
en. Most commands are obtained by touching a single key. 
a track number or address immediately respond with a 
r you to enter the value (decimal for track numbers, hex 
w, into drive insert your Hyperzap disk or a backup of 
t later). Make sure you have a write protect tab on your 
cidents until you know what you are doing. DO NOT press 
f you have a drive with faulty write protect switches or 

test disk you value or you may regret it. We are going to 
marks and data of the sectors on track 0. There are only 
ors for model I and III. 
o space between the A and the 00) 

ort delay while the disk is spun 8 times reading address 
aging the results. Now if you type D 00 you will see the 
00 listed. However, at this point the sector data has not 
he data mark is not neccessarily valid. Return to the main 
e Clear key and enter: 



S 00 



The disk will spin again while the sectors are read in the order they 
appeared in the track sector table. You will see a series of letter S and Ds 
appear on the screen, one for each sector read, B for single and D for 
double density. In this case you should just see the letters SD appear as 
there is i single and 1 double density sector. Now the sector data is in 
memory. Type D 00 again and you should see a screen as in Figure 2. Near the 
start of the track is a single density sector and its data is in memory 
starting at address 7D00. About half way round the disk is a double density 
sector and its data is at 7E00. The angular position in degrees round the 
disk of the address mark can be got by taking the Ang number given and 
multiplying by 360/6250. 

The cursor in Figure 2 points to the first sector and you can see the 
data as read into memory by typing M will will take you to Figure 3. Here 
you are in a memory examine/change mode. To- edit data you would have to type 
M again to go to the modify mode. For now assume that you have edited the 
sector data and return to the previous screen by typing R. 
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Now you are back, if you had actually modified the data you could write 
it back to disk by typing Z -for Zap. An alternative way to get data on 
individual sectors is, from this screen (2) to type R (for Read). This will 
allow you to read the data into any arbitary point in memory. You will be 
asked for the address. You could then edit it and rewrite it as before. 



Now return to the main 
read in single density. 



menu 



(hit the Clear key). We will do a track 



Type: 



R S 00 



The disk will spin and track 00 will be read in single density into memory 
starting at address E700. When the index hole comes round again reading will 
stop and the program will jump to the I mode (screen 3) showing something 
like Figure 4. You can now see all the features recorded on the track. If 
there was no single density data on the track you will just see garbage. In 
line E770 of figure 4 you can. see an FE byte. This is the address mark of 
the sector ID. Following this is 

00 00 00 01 F1D3 

which says that following this is a sector of track 00, spare 00, sector 

number 00, length code 01 and the CRC is F1D3. To check the CRC move the 

cursor till it is over the FE byte and touch the 1 key to set marker 1. Now 
as you advance the cursor the Length/CRC indicator lower left will show the 

distance or CRC from Marker 1. Touch the C key to toggle between these two 

modes. As the cursor passes over the second byte of the CRC the indicator 

should go to 0000 if all is correct and you are in the CRC display state. 

You can similarly read the track in double density by, from the main 
m e n u typing 

R D 00 

Try it and you should get something like Figure 5. Since the first part of 
the track is in single density you will have to advance in memory till you 
come to around F400 in memory in this case. Double density track reads are 
much more unreliable however and data bytes are often lost and replaced with 
00 by the floppy disk controller. You will therefore be unlikely to see an 
exact replica of the sector data unless it was formatted with some simple 
constant code and had not yet been written to on a sector by sector basis. 

If you want to look at another track, try track 1 which has 12 sectors, 
6 in double and 6 in single. Figure 6 shows what you should expect to see. 
One sector is off the screen and you would have to move the cursor down to 
see it. 



Making a Backup of your Disk. 
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Although there is an Autopilot program on your disk -for doing this 
automatically it is instructive to do it manually. To make a backup of your 
disk, use the XC whole disk copy feature on the main menu. Insert your 
original disk in the source drive and, if you have more than one drive, put 
a blank disk in the destination drive and set the parameter table to 
indicate which drive is the source and which the destination. To do this 
type P and set the parameter cursor to the top, if not already there. Select 
source or destination drive as appropriate using the left/right arrow keys 
to move the drive cursor. Now change the drive number by typing a space 
followed by a single digit 0-3. Exit by hitting the clear key. 
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Screen 1: *** Command Options *** 
A Read addr dirks XC Disk Copy 



C c 1 r Track Table 

D display 

I inspect memory 

J ## jump to ## 

S Read sectors 

3 Write sectors 

R S/D read track 

W Format Track 



B AutoBoot Disk 
Z Autopilot 
P Change Params 
+ Step & repeat 
T # seek track 
E comb. A,S,D 
H(elpful) facts 
YX Quit & reboot 



Parameter Sr 
Drive Number 
No of tracks 
Steps/Track 
Head at track 
Side 

Size 5/8 inch 
Stepping rate 
Track offset 
Sector skew 



ce Destn 


00 


01 


40 


40 


01 


01 


00 


• 00 


00 


00 


05 


05 


03 


03 


00 


00 


02 


02 


A 




- 


80A1 


- 


FFFF 


lear --> 



Hyperzap uses 
Sector data 
Autopi lot 



4300 - 7E5B Track/sector table 800 
8C00 - 8C00 Track buffer E70 
8800 - 8800 P Screen Print C 



F i g u r~ e 



The Main Menu Sczr-een 



Now, type A 00 to read the address marks on track ) 
S 00 to read the sector data into memory ) 
D 00 to show the screen below. « ) 



Alternatively 
these 3 commands 
can be replaced 
bv E 00 



b c r e e n Z : 
Physical 
track 00 

Sector 
Table 



» Tk Sp Sc Ln CRC DM Data Ang. TYP CRC Den 

01 00 00 00 01 Y FB 8C00 0371 IBM Y 3 

02 00 00 01 01 Y FB 8D00 3646 IBM Y D 



Total 02 

sectors 

Drive 00 
05 inch. 



Hyperzap uses 4300 - 7E5B 
Sector data 8C00 - 8E00 
Autopilot BBOO - 8800 



Track/sector table 
Track buffer 
P Screen Print 



8000 - 80B7 

E700 - FFFF 

Clear --> 



Fi gure 2 - Sector- Table -for - Tr ac k O 

Now type M to go to display of sector data (Fig 3) 
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Screen 3: ... 4 ... 8 ... C .. . Ascii equiv. 

Crsr:8C00 8C00 1806005600560B06F331FF4121EC37ED ..V.V 1.A..7. 

8C10 5B0242CD2242CD69422A0242E9CB4620 [ . B. "B. i B*. B. . F 
Limits: 8C20 FCC9CD9B423ED077060010FE7710FECD B>.w w... 

Lo:8C00 8C30 1D423653060A10FECD1D42CD9B427ECB .B6S B..B.. 

Hi:8CFF 8C40 67C821003C1 1013C01FF033620EDB021 g. ..<..<. ..6 ... 

8C50 5E421 1 1 03D7EB728FE 1 223 1 3 1 8F74469 "B. .=..(..#... Di 

Markers: 8C60 736B206661756C7400CD9B423A064247 sk f aul t . . . B: . BG 

M1:8C00 8C70 3A07424FC5ED53D742060AC5CDA142C1 :.B0..S.B B. 

M2:FFFF 8C80 2809ED5BD74210F3C34242C10D20E505 (..C.B...BB 

Length/ 8C90 CBCD9B42C5CD2F42C1 1BD53E0132E137 . . . B. . /B. . . >. 2. 7 
CRC :0001 8CA0 C936D0060A10FE060A36D010FECD9B42 .6 6 B 

Hyperzap uses 4300 - 7E5B Track/sector table 8000 - 80B7 
Sector data 8C00 - 8E00 Track buffer E700 - FFFF 
Autopilot 8800 - B800 P Screen Print Clear --> 

Figure 3 ■ Trac k Q , Sector - O Data 



To read track into memory, single density type: R S 00 

Screen 3: ... 4 ... 8 ... C .. . Ascii equiv. 

Crsr:E7A0 E7A0 FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 

E7B0 FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 

Limits: E7C0 FFFF80000000FE00000001F1D3FFFFFF 

Lo:E700 E7D0 FFFFFFFFFFFFFFFF01000000000000FB 

Hi:F338 E7E0 1806005600560B06F331FF4 121EC37ED . .V.V 1.A..7. 

E7F0 5B0242CD2242CD69422A0242E9CB4620 C . B. "B. l B*. B. . F 
Markers: ESOO FCC9CD9B423ED077060010FE77I0FECD B>.w w... 

M1:FC00 ES10 1D423653060A1 0FECD1D42CD9B427ECB .B6S B..B.. 

M2:FFFF E820 67C821003C1 1 013C01FF033620EDB021 g.. <...<... 6 ... 
Length/ E830 5E421 1 103D7EB728FE12231318F74469 -B. .=..(..#... Di 
CRC :EBA1 EB40 736B206661756C7400CD9B423A064247 sk i aul t . . . B: . BG 

Hyperzap uses 4300 - 7E5B Track/sector table 8000 - 80B7 
Sector data BC00 - F339 Track buffer E700 - FFFF 
Autopilot 8800 - 8800 P Screen Print Clear --> 

Fig 4 , Track r-ead in single density 
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To read track into memory, double density type: R D 00 

... 4 ... 8 ... C . . . Ascii equiv. 

4E4E4E4E4E4E4E4E00000000000000A1 NNNNNNNN 

A1A1FE00000101FA0C4E4E4E4E4E4E4E NNNNNNN 

4E4E4E4E4E4E4E4E4E4E4E4E4E4E4E00 NNNNNNNNNNNNNNN. 

0000000OO00O0O0OOOOOOO0OA1A1A1FB 

1806005600560B06F331FF42ED5B0243 . . VV l.B.C.C 

CD2143CD6D432A0443E9DBF0CB4720FA ..C.mC*.C G . 

C9CD9F433EDOD3F0060010FED3F010FE . . . C > 

CD1A433E53D3F0060A10FECD1A43CD9F . .OS. ... C. . 

43DBF0CB67C821003C11013C01FF0336 C. .. g ...<..<... 6 
20EDB02i624311103D7EB723FEi22313 ... bC. .=..(.. #. 
18F74469736B206661756C7400CD9F43 ..Disk fault... C 

Hyperzap uses 4300 - 7E5B Track/sector table 8000 - 80B7 
Sector data 8C00 - FF62 Track buffer E700 - FFFF 
Autopilot 8800 - 8800 P Screen Print Clear --> 

Pig 5 ■ Track read in doubl e density 



Screen 3: 




Crsr:F546 


F530 




F540 


Limi ts: 


F550 


Lo:E700 


F560 


Hi : FF61 


F570 




F580 


Markers: 


F590 


M1:F542 


F5A0 


M2:FFFF 


F5B0 


Length/ 


F5C0 


CRC sFAOC 


F5D0 



Screen 2: 


# 


Tk 


Sp 


Sc 


Ln 


CRC 


DM 


Data 


Ang. 


TYP CRC 


Den 




Physical > 


01 


01 





06 


01 


Y 




FB 


8C00 


0201 


IBM 


Y 


D 




track 1 


02 


01 


00 


05 


01 


Y 




FB 


9200 


0514 


IBM 


Y 


D 




Sector 


03 


01 


00 


04 


01 


Y 




FB 


3 D 


0850 


IBM 


Y 


D 




Table 


04 


01 





03 


01 


Y 




FB 


9300 


1175 


IBM 


Y 


D 






05 


01 


00 


02 


01 


Y 




FB 


BE 00 


1513 


IBM 


Y 


D 




Total 12 


06 


01 


00 


01 


01 


Y 




FB 


9400 


1831 


IBM 


Y 


D 




sectors 


07 


01 


00 


06 


01 


Y 




FB 


8F00 


2393 


IBM 


Y 


S 






08 


01 


00 


05 


01 


Y 




FB 


9500 


2987 


IBM 


Y 


S 




Drive 00 


09 


01 


00 


04 


01 


Y 




FB 


9000 


3580 


IBM 


Y 


r- 
D 




05 inch. 


10 


01 


00 


03 


01 


Y 




FB 


9600 


4175 


IBM 


Y 


S 






11 


01 


00 


02 


01 


Y 




FB 


9100 


4772 


IBM 


Y 


s 




Hyperzap uses 


4300 ■ 


- 7E5B 






Ti 


r ack/sect 


:or tc 


ibl.e 


8000 - 


813B 


Sector data 


8C00 ■ 


- 9B00 






Ti 


r&c\ 


i buf< 


: er 




E700 - 


FFFF 


Autopi lot 


8800 • 


- 8800 






P 


Screen Print 






CI ear 





Fig 6» ■ H yperzap track 1 sectors 
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Appendix 1_= S P ecial Disk Backup 



Many disks can be copied without any manual intervention. However some 
are made with specific errors recorded on them so that regular copying 
procedures will not be reproduced exactly the same. Typical of these are 
ones where a CRC error is deliberately introduced in the sector data at the 
■format stage. As an example let us consider disks which use the loader by 
Paul Brandon. Examples of this come from Med Systems and Melbourne House. 

You can identify this type of disk because it comes as a dual booting 
Model I / 1 1 1 with one of the tracks, typically number 3 having only 6 sectors 
the 6th sector giving an error when you try and copy it. Apart from track 3 
and track zero all tracks have 10 sectors of single density. Track zero has 
at least one single and one double density sector. 

To make a backup of your disk do a regular disk copy of the entire disk 
with the exception of track 3. Some disks such as Asylum only have 12 tracks 
while others such as Penetrator have as many as 32. Now we have to go back 
and copy track 3. To do this we must create a specially formatted track 
which will have space for the first 5 sectors which are normal plus a 
specially formatted section corresponding to the apparent 6th sector. Then, 
when the track is formatted we can write in the data for the 5 good sectors. 



First, on the original 
into memory. Type: 

A 3 
D 03 
There are 6 sectors apparen 
give an error message when y 
sector 6 and then delete the 
the sector data for sectors 
and we have to replace it wi 
the same effect at format ti 

R S 
The start of the track will 
of sector 6. Type: 

S 03014 



we will read the address marks and sector data 

(program reads address marks) 
(display sector info.) 
tly but the 6th is there to fool you and will 
ou try to read it. Note the angular position of 
entry and return to the main menu. Now read in 
1 to 5 using S 03. Sector 6 is a false sector 
th a special block of data to be used to create 
me. From the main menu type: 
3 (to read track 03 in single density) 
be displayed at E700. Now search for the start 



You should 
up-arrow ke 
here. We ar 
sector data 
to the disp 
block. Als 
sometimes t 
modify mod 
suf f i ci ent 
increase th 
mark. Set m 
important d 
set marker 
data for se 
to the ques 



now see 
y ) . The 
e going 

was ind 
lay. Thi 
o check 
h e s e get 
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ata - ad 
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8200 you should see something like Figure 3. 

Now, go to the sector table and edit the entry -for sector 6 so it looks 
like Figure 4. In other words sector 6 is now defined as a type W sector 
which will only be used at -format time. The -format subroutine will take the 
information on the 6 sectors and build an image in memory of 5 blank sectors 
plus a zone with a copy o-f the special block o-f data -for sector 6. Then this 
will be written to disk and the controller will replace the F7 bytes with 
CRCs. Once this is done the 5 good sectors can be written onto the track in 
their respective places using the Q command. 

Return to the main menu (using the CLR key) and type: 
W 03 (to -format the track) 
Q 03 (to write the -first 5 sectors) 
We are finished. Put a write protect tab on and try booting it. 



Screen 2 : 


# 


Tk 


Sp 


Sc 


Ln 


CRC 


DM 


Data 


Ang. 


TYP CRC 


Den 


Track s 


01 


03 


00 


1A 


01 


Y 


F8 


7D00 


0067 


IBM Y 


S 


sector 


02 


03 


00 


19 


01 


Y 


FB 


7E00 


0665 


IBM Y 


S 


table 


03 


03 





22 


01 


Y 


F8 


7F00 


1265 


IBM Y 


S 




04 


03 


00 


36 


01 


Y 


F8 


B000 


1B64 


IBM Y 


g 


Use arrows 


05 


03 





29 


01 


Y 


FB 


8100 


2465 


IBM Y 


3 


to scroll 


> 06 


03 


01 


4E 


01 


Y 


FB 


B200 


2065 


X N 


S 



FIGURE 1. Track 3 sectors information as originally read in 



9 c r e e n 3 




... 4 ... 8 ... C .. . 


C r 5 r : E C E D 


ECED 


FFFFFFFFFFFF0OOO0OOO0OO0O0O0FE03 




ECFD 


014E0173FCFFFFFFFFFFFFFFFFFF0000 


Limits: 


ED0D 


UOOOOOOoOOOOFBE 1 E 1 2AU544E5C3004C 


Lo: E700 


EDID 


830EE5E5E5E5E5E5E5E5E5E5E5E5E5E5 


Hi : Fl IF 


ED2D 


E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 




ED3D 


E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 


Markers: 


ED4D 


E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 


Ml.-ECED 


ED5D 


E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 


M2:EF6D 


ED6D 


E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 


Length/ 


ED7D 


E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 


CRC : 0001 


ED8D 


E5E5E5E5E5E5E5E5E5E5E5E5E5E5E55E 



A s c i i e q u i v 



.N 



Figure 2: Start of Track 3, Sector 6 data. Obtained by doing a 
single density track read. Note CRC at EDID (underlined). There 
are more between here and the end of the significant data. The 
length of the blocks of zeros has been extended to ensure sync. 
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Screen3 0...4...8...C... Ascii equiv. 

Crsr:8200 8200 FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 

B210 FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 

Limits: 8220 FFFFFFFFFFFO0O00O0OOO0000OO0FEO3 

Lo:E700 8230 01 4E01F7FFFFFFFFFFFFFFFFFF000000 .N 

Hi : Fl IF 8240 OOOO00O0OOF8E1E12A0544E5C3OO4CF7 *.D...L. 

8250 E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 

Markers: 8260 E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 

Ml : ECED 8270 E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 

M2:EF6D 8280 E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5 

Figure 3: Start of sector 6 data a-fter block move. Note how the 
CRCs in Fig 2 have been replaced by F7s (underlined). 



Tk Sp Sc Ln CRC DM Data Ang. TYP CRC Den 

03 00 1A 01 Y FB 7D00 0067 IBM Y S 

03 00 19 01 Y F3 7E00 0665 IBM Y S 

03 00 22 01 Y F8 7F00 1265 IBM Y S 

03 00 36 01 Y F8 8000 1864 IBM Y S 

03 00 29 01 Y F8 8100 2465 IBM Y S 

Block length: 0298 8200 3100 W S 

Figure 4: Track 3 sector table a-fter editting sector 6. 



Screen 2: 


# 


Track s 


01 


sector 


02 


table 


03 




04 


Use arrows 


05 


to scroll 
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Track Zero of your disk is -formatted to contain only two sectors. 
Sector zero is in single density and is -for use on model I computers, Sector 
1 is in double density and is -for Model III/IV machines. 

The pages that follow contain the complete source listing for these 
sectors. Please feel free to use them either as is or modified for your own 
purposes. You can extract the object code from your disk by the following 
method: 

- Do a read of address marks of track zero by typing A 00 - 
Do a read of sector data by typing S 00 - Go to the track 
display page with D 00 



You now have a display showing two sectors 
can inspect and modify the data by typing M. 



and their statistics. You 



i n s 
1 oad 
4200 
load 
sect 
trac 
each 
sect 
vour 



The r 
ingle 
e d and 
H and 
l n g of 
ors in 
k cent 

s e c t o 
ors pe 

own p 



est of 
density 

then 
on the 

the p r 
( i n r 

i n u i n g 
r form 
r track 
r o g r a m s 



the tracks on your disk have 12 sectors, 6 in double and 6 
. When you boot up the appropriate sector on track zero is 
executed. On the Model I it loads and starts running at 
Model III/IV at 4300H. The head is stepped to track i and 
ogram begins. Now the loader loads the 6 single or double 
everse sequence i.e. 6,5,4,3,2,1) and steps to the next 
until all tracks are loaded. The 3rd through 7th byte of 
a user alterable table specifying the number of tracks, 
, load and start addresses. You can modify these to suit 
as neccessarv. 



A disk set up with this format boots very fast. This is because out of 
each disk revolution, which takes 200 mS, only part is used to read data. 
Sufficient time remains to step to the next track before data on that track 
comes round again. The present disk has 12 tracks including track and so 
takes 12 times 200 mS or 2.4 seconds to boot. 



Hyperzap Version 3.0 



-=<*> = • 



Copyright 1983, Hypersoft 



Page 30 



Model I Boot Sector 



Appendix 2 



4200 
5200 



37 El 
37EC 
37EC 
37ED 
37EE 
37EF 

4200 
4201 
4204 
4207 
420A 
420D 
4210 



F3 

310044 

21EC37 

110052 

CD1842 

CD5F42 

C30052 



4213 CB46 
4215 20FC 
4217 C9 



4218 
421B 
421D 
421E 
4220 
4222 
4223 
4225 
4228 
422A 
422C 
422E 
4231 
4234 
4235 
4237 



CD8D42 

3ED0 

77 

0600 

10FE 

77 

10FE 

CD1342 

3653 

060A 

10FE 

CD1342 

CDBD42 

7E 

CB67 

C8 



4238 21003C 

423B 11013C 

423E 01FF03 

4241 3620 

4243 EDBO 

4245 215442 

4248 11103D 

424B 7E 



00010 

00020 

00030 

00040 

00050 

00060 

00070 

00080 

00090 

00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

001 BO 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

00380 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 

00530 

00540 



Copyright (C) 1983 Hypersoft, M.J.Gingell. 

Model I Bootstrap loader, assumes 6 sectors of 

256 bytes, single density on each successive track 

Sector sequence 6,5,4,3,2,1 

Version 1 . 1 May-14-83 
ORG 04200H 
L0ADAD EQU 5200H ;Address to start loading 
; and running program 

;FDC control registers 
DRIVE EQU 37E1H 
C0MAND EQU 37ECH 
STATUS EQU 37ECH 
TRACK EQU 37EDH 
SECTOR EQU 37EEH 
DATA EQU 



Drive motor trigger 
Command register 
Status register 
Track number register 
Sector number register 



37EFH ;Data I/O register 



BOOT 



NOTBUS 



TRACK 1 



DELAY1 

DELAY2 
STEPIN 



WREADY 
WRDYO 



; CI ear 

ERROR 



COPY 



DI 

LD 

LD 

LD 

CALL 

CALL 

JP 

BIT 

JR 

RET 

CALL 
LD 
LD 
LD 

DJNZ 
LD 

DJNZ 
CALL 
LD 
LD 

DJNZ 
CALL 
CALL 
LD 
BIT 
RET 
screen 
LD 
LD 
LD 
LD 

LDIR 
LD 
LD 
LD 



SP,BO0T+2O0H 

HL,C0MAND 

DE,L0ADAD 

TRACK1 

LOADER 

LOADAD 

0, (HL) 
NZ, NOTBUS 



RETRIG 
A,0D0H 
(HL) ,A 
B,0 

DELAY1 
(HL) ,A 
DELAY2 
NOTBUS 
(HL) ,53H 
B, 10 
WREADY 
NOTBUS 
RETRIG 
A, (HL) 
4, A 
Z 
and print error 
HL,3C00H 
DE,3C01H 
BC,3FFH 
(HL) ,20H 



;Disable interupts 
;Set stack pointer 
;HL = Command/Status 
;DE is storage pointer 
;Start, Seek Track 1 
;Load program 
;Run it 

;Wait till not busy 



; Select drive 
;Force FDC interupt 

;Delay while command 
;takes effect 
; Repeat 

;Wait till not busy 
;Step out to next track 
: Del ay 

;Wait till not busy 
;Retrigger drive 
;Get status 
;Seek error ? 
;No OK Quit 
message 

;Clear Screen 



HL,DSKERR 
DE,3D10H 
A, (HL) 



;FAULT Message 
:Get next char 
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424C 
424D 
424F 
4250 
4251 
4252 
4254 
4258 
425E 

425F 
4262 
4264 
4266 
4267 
426B 
426D 
426E 
4271 
4272 
4274 
427S 
427A 
427D 
427E 
427F 
42B1 
4282 
4233 
4286 
4287 
428A 
428B 



428D 
42SF 
4292 



4293 
4295 
4297 
4299 
429B 
429D 
429F 
42A2 
42A3 
42A6 
42A9 
42AB 
42AC 
42AE 



B7 

2BFE 

12 

23 

13 

18F7 

446973 

206661 

00 

CD8D42 

06 0C 

0E06 

C5 

ED53C9 

6 A 

C5 

CD9342 

CI 

2809 

ED5BC9 

10F3 

C33842 

CI 

0D 

20E5 

05 

CB 

CD8D42 

C5 

CD2542 

CI 

18D7 



00550 

00560 HANG 

00570 

00580 

00590 

00600 
6B 00610 DSKERR 
756C74 

00620 

00630 ; 

00640 LOADER 

00650 

00660 TRKLOO 

00670 SECLOO 
42 00680 

00690 

00700 SECTRY 

00710 

00720 

0073 
42 00740 

00750 

00760 

00770 SECOK 

00780 

00790 

00800 

00810 

00820 

00830 

00840 

00850 



OR 


A 


JR 


Z,HANG 


LD 


(DE) ,A 


INC 


HL 


INC 


DE 


JR 


COPY 


DEFM 


'Disk fault 



3E01 

32E137 
C9 



36D0 

060 A 

10FE 

060A 

36D0 

10FE 

CD8D42 

79 

32EE37 

01EF37 

3E88 

77 

3E05 

3D 



00860 
00870 
008 SO 
00B90 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00980 
00990 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 



DEFB 

CALL 

LD 

LD 

PUSH 

LD 

LD 

PUSH 

CALL 

POP 

JR 

LD 

DJNZ 

JP 

POP 

DEC 

JR 

DEC 

RET 

CALL 

PUSH 

CALL 

POP 

JR 





RETRIG 
B, 12 

C,6 

BC 

(DETEMP) ,DE 

B, 10 

BC 

RDSEC 

BC 

Z, SECOK 

DE, (DETEMP) 

SECTRY 

ERROR 

BC 

C 

NZ, SECLOO 



RETRIG 
BC 

STEP IN 
BC 
TRKLOO 



; K e e p drive turning 
RETRIG LD A,l 

LD (DRIVE), A 

RET 

;Read next sector #C 



;Null ends string print 
;Hang up when done 
;Copy char to screen 
;Advance pointers 

;Loop till done 



; # tracks 

;6 sectors/track 

;Save store point 
;# tries /sector 
jbefore aborting 

;Get Try Count back (in B) 
;H status not ok retry 
;restore storage pointer 
;Decrement Try Counter 

;Get track/sector count 
;Decrement sector counter 
;Loop till 6 sectors read 
; A d v a n c e 1 track 
;Loop till ail tracks read 



; S t e p to next track 



RDSEC 
DELAY3 

DELAY4 



DELAYS 



LD 

LD 

DJNZ 

LD 

LD 

DJNZ 

CALL 

LD 

LD 

LD 

LD 

LD 

LD 

DEC 



(HL) ,0D0H 

B, 10 

DELAY3 

B, 10 

(HL) ,0D0H 

DELAY4 

RETRIG 

A,C 

(SECTOR) , 

BC,DATA 

A,88H 

(HL) ,A 

A,5 

A 



; Interupt controller 
; Del ay 

; Repeat 



;Keep drive 
;Get sector 



goi ng 
number 



A 



; Read sector 
; Issue it to 
; Delay 



command 
control 1 er 
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42AF 20FD 01080 JR NZ, DELAYS 

42B1 7E 01090 GETDRQ LD A,(HL) ;Read Status register 

42B2 CB4F 01100 BIT 1,A ;test DRQ bit 

42B4 C2C342 OHIO JP NZ,GETBYT ;Yes get data 

42B7 E601 01120 AND 1 ; No test busy bit 

42B9 C2B142 01130 JP NZ, GETDRQ ;Keep going while still busy 

42BC CDSD42 01140 CALL RETRIG ;Else retrigger drive timer 

42BF 7E 01150 LD A,(HL) ;Test Status: CRC, 

42C0 E69C 01160 AND 9CH ;RNF, Lost data, Drive ready 

42C2 C9 01170 RET ;and exit. 

42C3 OA 01180 GETBYT LD A,(BC) ; Read Controller Data Reg 

42C4 12 01190 LD (DE),A ;and store byte 

42C5 13 01200 INC DE ;Advance store pointer 

42C6 C3B142 01210 JP GETDRQ 

01220 ; 

42C9 0000 01230 DETEMP DEFW ; store for DE in case sector 

01240 ; read must be restarted. 

4200 01250 END BOOT 



Hyperzap Version 3.0 _=<*>=_ Copyright 1983, Hypersoft 



Appendix 2 



Model 3 Boot Sector 



Page 



4300 



00F4 
00F0 
00F0 
00F1 
00F2 
OOF 3 

4 300 1806 

4302 0053 

4304 0053 

4 306 OA 

4307 06 



4308 
4309 
430C 
4310 
4313 
4316 
4319 



F3 

3 1 F F 4 2 

ED5B0243 

CD2143 

CD6D43 

2A0443 

E9 



431 A DBFO 

431C CB47 

43 IE 20FA 

4320 C9 



4321 
4324 
4326 
4328 
432A 
432C 
432E 
4330 
4333 
4335 
4337 
4339 
433B 
433E 
4341 
4343 
4345 



CD9F43 

3ED0 

D 3 F 

0600 

10FE 

D3F0 

10FE 

CD1A43 

3E53 

D3F0 

060 A 

10FE 

CD1A43 

CD9F43 

DBFO 

CB67 

C8 



; Model 
;256 by 
; track . 
; Versi o 



;FDC co 

DRIVE 

COMAND 

STATUS 

TRACK 

SECTOR 

DATA 

ii 

BOOT 

; T a b 1 e 

LOADAD 

STRTAD 

NTRAKS 

NSECTS 

j 
B00T1 



00010 
00020 
00030 
00040 
00050 
00060 
00070 
00080 
00090 
00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
2 4 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
00460 
00470 
00480 
00490 
00500 
00510 
00520 
00530 
00540 :Clear 
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Ill Bootstrap loader, expects 6 sectors o-f 
tes, double density on each successive 

Sector sequence 6,5,4,3,2,1 
n 1.1 May-15-83 

ORG 04300H 

and running program 
ntrol register PORT addresses 



NOTBUS 



TRACK1 



DELAY1 

DELAY2 
STEPIN 



WREADY 
WRDYO 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



0F4H 
OFOH 
OFOH 
0F1H 
0F2H 
0F3H 



Drive motor trigger 
Command register 
Status register 
Track number register 
Sector number register 
;Data I/O register 



JR B00T1 
of alterable parameters 
DEFW 5300H ;Address to start loading 
DEFW 5300H ;Start address 
DEFB 10 ;Number of tracks 



DEFB 

DI 

LD 

LD 

CALL 

CALL 

LD 

JP 

IN 
BIT 
JR 
RET 

CALL 
LD 
OUT 
LD 

DJNZ 
OUT 
DJNZ 
CALL 
LD 
OUT 
LD 

DJNZ 
CALL 
CALL 
IN 
BIT 
RET 
screen 



Number o-f sectors / track 



SP,B0QT-1 

DE, (LOADAD) 

TRACK1 

LOADER 

HL, (STRTAD) 

(HL) 

A, (STATUS) 

0,A 

NZ, NOTBUS 



;Disable interupts 
;Set stack pointer 
; DE is storage ptr 
;Start Drive, Seek Tr 1 
;Load program 
; Run i t 



;Test if busy 

; Wai t till not busy 



RETRIG 
A,0D0H 
(COMAND) ,A 
B,0 

DELAY1 
(COMAND) ,A 
DELAY2 
NOTBUS 
A,53H 
(COMAND) ,A 
B, 10 
WREADY 
NOTBUS 
RETRIG 
A, (STATUS) 
4, A 
Z 
and print error 



; S e 1 e c t drive 
;Force FDC interupt 

;Delay while command 
; takes effect 
; Repeat 

;Wait till not busy 
;Step out to 
;next track 
;Delay 

;Wait till not busy 
;Retrigger drive 
;Get status 
;Seek error ? 
;No OK Quit 
message 
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Model 3 Boot Sector 



Appendix 2 



4346 


21003C 


00550 


ERROR 


LD 


HL,3C00H 


4349 


11013C 


00560 




LD 


DE,3C01H 


434C 


01FF03 


00570 




LD 


BC,3FFH 


434F 


3620 


00580 




LD 


(HL) ,20H 


4351 


EDBO 


00590 




LDIR 




4353 


216243 


00600 




LD 


HL, DSKERR 


4356 


11103D 


00610 




LD 


DE,3D10H 


4359 


7E 


00620 


COPY 


LD 


A, (HL) 


435A 


B7 


00630 




OR 


A 


435B 


28FE 


00640 


HANG 


JR 


Z,HANG 


435D 


12 


00650 




LD 


(DE),A 


435E 


23 


00660 




INC 


HL 


435F 


13 


00670 




INC 


DE 


4360 


1BF7 


006BO 




JR 


COPY 


4362 


4469736B 


00690 


DSKERR 


DEFM 


'Disk -fault 


4366 


20666175 


6C74 








436C 


00 


00700 
00710 


5 


DEFB 





436D 


CD9F43 


00720 


LOADER 


CALL 


RETRIG 


4370 


3A0643 


00730 




LD 


A, (NTRAKS) 


4373 


47 


00740 




LD 


B,A 


4374 


3A0743 


00750 


TRKLQO 


LD 


A, (NSECTS) 


4377 


4F 


00760 




LD 


C,A 


4378 


C5 


00770 


SECLOO 


PUSH 


BC 


4379 


ED53EB43 


00780 




LD 


(DETEMP) ,DE 


437D 


060A 


00790 




LD 


B,10 


437F 


C5 


00800 


BECTRY 


PUSH 


BC 


4380 


CDA443 


00810 




CALL 


RDSEC 


4383 


CI 


00820 




POP 


BC 


4384 


2809 


00830 




JR 


Z, SECOK 


4386 


ED5BEB43 


00840 




LD 


DE, (DETEMP) 


433A 


10F3 


00850 




DJNZ 


SECTRY 


438C 


C34643 


00860 




JP 


ERROR 


438F 


CI 


00870 


SECOK 


POP 


BC 


4390 


0B 


00880 




DEC 


C 


4391 


20E5 


00890 




JR 


NZ, SECLOO 


4393 


05 


00900 




DEC 


B 


4394 


C8 


00910 




RET 


7 


4395 


CD9F43 


00920 




CALL 


RETRIG 


4398 


C5 


00930 




PUSH 


BC 


4399 


CB3043 


00940 




CALL 


STEPIN 


439C 


CI 


00950 




POP 


BC 


439D 


18B5 


00960 
00970 


5 


JR 


TRKLOO 






00980 


;Keep d 


ri ve t 


urning 


439F 


3E81 


00990 


RETRIG 


LD 


A,S1H 


43A1 


D3F4 


01000 




OUT 


(DRIVE)iA 


43A3 


C9 


01010 
01020 


5 


RET 








01030 


;Read next sector #C 


43A4 


3ED0 


01040 


RDSEC 


LD 


A,0D0H 


43A6 


B3F0 


01050 




OUT 


(COMAND) ,A 


43A8 


060A 


01060 




LD 


B, 10 


43AA 


10FE 


01070 


DELAYS 


DJNZ 


DELAY3 



;Clear Screen 



;FAULT Message 

Get next char 
Null ends print 
Hang up when done 
Copy char to screen 
Advance pointers 

;Loop till done 



; # tracks 

;6 sectors/track 

;Save store point 
;# tries /sector 
jbe-fore aborting 

Get Try Count back (in B) 
If status not ok, retry 
restore storage pointer 
Decrement Try Counter 

;Get trck/sctr count back 
: Decrement sector counter 
;Loop till 6 sectors read 
;Advance 1 track 
;Loop till all tracks read 



;Step to next track 



;double density, drive 



jlnterupt controller 
; Delay 
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Model 


3 Boot Sector 


Pai 


43AC 


060A 


01080 




LD 


B,10 


; Repeat 


43AE 


D3F0 


01090 




OUT 


(COMAND),A 




43B0 


10FE 


01100 


DELAY4 


DJNZ 


DELAY4 




43B2 


CD9F43 


oino 




CALL 


RETRIG 


;Keep drive going 


43B5 


79 


01120 




LD 


A,C 


;Get sector number 


43B6 


D3F2 


01130 




OUT 


(SECTOR) ,A 




43B8 


2683 


01140 




LD 


H,83H 


; Bi t masks 


43BA 


2E02 


01150 




LD 


L,2 




43BC 


3E88 


01160 




LD 


A,8BH 


;Read sector command 


43BE 


D3F0 


01170 




OUT 


(COMAND) ,A 


;Issue it to controller 


43C0 


3E05 


01180 




LD 


A, 5 


;Delay 


43C2 


3D 


01190 


DELAYS 


DEC 


A 




43C3 


20FD 


01200 




JR 


NZ, DELAYS 




43C5 


DBFO 


0121 


RDSEC1 


IN 


A, (STATUS) 


;Read Status register 


43C7 


A4 


01220 




AND 


H 


;test DRQ,BUSY READY 


43C8 


E2C543 


01230 




JP 


P0,RDSEC1 




43CB 


DBF3 


01240 


RDSEC2 


IN 


A, (DATA) 




43CD 


12 


01250 




LD 


(DE),A 


;Store it 


43CE 


13 


01260 




INC 


DE 


;Advance pointer 


43CF 


DBFO 


01270 


RDSEC3 


IN 


A, (STATUS) 




43D1 


A5 


01280 




AND 


L 




43D2 


20F7 


01290 




JR 


NZ,RDSEC2 




43D4 


DBFO 


0130 




IN 


A, (STATUS) 




43D6 


A5 


01310 




AND 


i_ 




43D7 


20F2 


01320 




JR 


NZ,RDSEC2 




43D9 


DBFO 


01330 




IN 


A, (STATUS) 




43DB 


A5 


01340 




AND 


L 




43DC 


20ED 


01350 




JR 


NZ,RDSEC2 




43DE 


DBFO 


01360 




IN 


A, (STATUS) 




43E0 


CB47 


0137 




BIT 


0,A 


;Still Busy ? 


43E2 


2804 


01330 




JR 


Z, SEXIT 




43E4 


CB7F 


01390 




BIT 


7, A 


;Not Ready ? 


43E6 


2SE7 


01400 




JR 


Z,RDSEC3 




43E8 


E61C 


1410 


SEXIT 


AND 


1CH 


;Test RNF CRC Not Ready 


43EA 


C9 


01420 
01430 


5 


RET 






43EB 


0000 


01440 


DETEMP 


DEFW 





jstore -for DE in case 






01450 


5 




sector 


read must be restarted. 


4300 




01500 




END 


BOOT 
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User Registration 
USER REG I STR AT ION 



We are in the constant state of never being satisfied with our programs 
and are always making improvements. If you have any suggestions please write 
to us and if it is worthwhile we will endeavour to incorporate them. In 
return we will give you a free copy of the latest revision of the program. 
(That means you must return your original disk and we will place a new 
program on it at no charge). 

If vou complete the registration form below and tail it in we will keep 
you informed of updates and new versions of HYPERZAP and other HyperSoft 
products. New versions including manual will be available to registered 
users for 110 plus shipping. (You must return your old disk). 



Please return to: HyperSoft, 

P.O. 



Box 



Raleigh N.C. 27609, USA 
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